home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / uwritec.z / uwritec
Encoding:
Text File  |  1998-10-30  |  6.0 KB  |  132 lines
  1.  
  2.  
  3.  
  4. uuuuwwwwrrrriiiitttteeeecccc((((DDDD3333))))                                                        uuuuwwwwrrrriiiitttteeeecccc((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _uuuu_wwww_rrrr_iiii_tttt_eeee_cccc - return a character from space described by _uuuu_iiii_oooo(D4) structure
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_uuuu_iiii_oooo_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _uuuu_wwww_rrrr_iiii_tttt_eeee_cccc_((((_uuuu_iiii_oooo______tttt _****_u_i_o_p_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _u_i_o_p      Pointer to the _uuuu_iiii_oooo structure.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _uuuu_wwww_rrrr_iiii_tttt_eeee_cccc copies a character from the space described by the _uuuu_iiii_oooo structure
  21.      pointed to by _u_i_o_p and returns the character to the caller.
  22.  
  23.      The _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg member of the _uuuu_iiii_oooo structure specifies the type of space
  24.      from which the copy is made.  If _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______SSSS_YYYY_SSSS_SSSS_PPPP_AAAA_CCCC_EEEE the
  25.      character is copied from a kernel address.  If _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to
  26.      _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE the character is copied from a user address.
  27.  
  28.      If the character is successfully copied, _uuuu_wwww_rrrr_iiii_tttt_eeee_cccc updates the appropriate
  29.      members of the _uuuu_iiii_oooo and _iiii_oooo_vvvv_eeee_cccc(D4) structures to reflect the copy
  30.      (_uuuu_iiii_oooo______oooo_ffff_ffff_ssss_eeee_tttt and _iiii_oooo_vvvv______bbbb_aaaa_ssss_eeee are incremented and _uuuu_iiii_oooo______rrrr_eeee_ssss_iiii_dddd and _iiii_oooo_vvvv______llll_eeee_nnnn are
  31.      decremented) and returns the character to the caller.
  32.  
  33.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  34.      If successful, _uuuu_wwww_rrrr_iiii_tttt_eeee_cccc returns the character.  _----_1111 is returned if the
  35.      space described by the _uuuu_iiii_oooo structure is empty or there is an error.
  36.  
  37. UUUUSSSSAAAAGGGGEEEE
  38.    LLLLeeeevvvveeeellll
  39.      Base only if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE.
  40.  
  41.      Base or Interrupt if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______SSSS_YYYY_SSSS_SSSS_PPPP_AAAA_CCCC_EEEE.
  42.  
  43.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  44.      May sleep if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE.
  45.  
  46.      Driver-defined basic locks and read/write locks may be held across calls
  47.      to this function if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is _UUUU_IIII_OOOO______SSSS_YYYY_SSSS_SSSS_PPPP_AAAA_CCCC_EEEE but may not be held if
  48.      _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE.
  49.  
  50.      Driver-defined sleep locks may be held across calls to this function
  51.      regardless of the value of _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg.
  52.  
  53.    WWWWaaaarrrrnnnniiiinnnnggggssss
  54.      When holding locks across calls to this function, multithreaded drivers
  55.      must be careful to avoid creating a deadlock.  During the data transfer,
  56.      page fault resolution might result in another I/O to the same device.
  57.      For example, this could occur if the driver controls the disk drive used
  58.      as the swap device.
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. uuuuwwwwrrrriiiitttteeeecccc((((DDDD3333))))                                                        uuuuwwwwrrrriiiitttteeeecccc((((DDDD3333))))
  70.  
  71.  
  72.  
  73. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  74.      _iiii_oooo_vvvv_eeee_cccc(D4), _uuuu_iiii_oooo(D4), _uuuu_iiii_oooo_mmmm_oooo_vvvv_eeee(D3), _uuuu_rrrr_eeee_aaaa_dddd_cccc(D3)
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.